[% page.title = 'API Method: relation items creating'
   page.tab = 'api'
%]

<h2>HEAD /:user_id/relations/:relation_id/creating</h2>

<p>
Tests whether items are still in the process of being created in the relation by JSONMatch. This method can be polled to detect when the JSONMatch has finished creating all the relation items as a result of a transformation or data import. Do not poll more frequently than every minute.
Returns a 200 OK HTTP status code if there are web pages still to be fetched. Otherwise returns 404 Not Found.
</p>

<h3>URL:</h3>
<code>[% site.url %]/<em>user_id</em>/relations/<em>relation_id</em>/creating</code>

<h3>Formats (<a href="formats">about return formats</a>):</h3>
<p>Irrelevant because no response body is returned.</p>

<h3>HTTP Methods (<a href="http-methods">about HTTP methods</a>):</h3>
<code>HEAD</code> 

<p>Clients that can not issue <code>HEAD</code> requests can use <code>GET</code> with the added parameter <code>_method=HEAD</code></p>

<h3>Requires Authentication (<a href="authentication">about authentication</a>):</h3>
<code>true</code>

<h3>Parameters:</h3>
<ul>
<li><code>relation_id</code>.  Required. The ID of the relation into which items are being imported.</li>
<ul>
<li>Example: <code>[% site.url %]/kdd09/relations/pc/creating</code><br/>
</ul>
</li>
</ul>

<h3>Usage Examples:</h3>
<blockquote>
<h4>cURL (<a href="curl">about cURL</a>):</h4>
<code>curl -X HEAD -H "Token:mytoken" [% site.url %]/kdd09/relations/pc/creating</code><br/>
</blockquote>

<h3>Response (<a href="return-values">about return values</a>):</h3>

<p>
A response header is returned with the result in the HTTP status.
No response body is returned.
</p>


